Skip to main content

📃 Import certificates to your browser

You must import two certificates to your favorite browser’s certificate store if you want to log in to the console and avoid the security warnings when you visit it.

tip

The Windows and Debian installers should add these certificates for you but if you need to import them, here's how you can do it.

1. The Certificate Authority (ca.cer):​

The Certificate Authority (CA) certificate file should be in the following locations:

  • Docker: certificates/ca/ca.cer in the docker compose folder
  • Linux: /etc/openuem-server/certificates/ca/ca.cer
  • Windows: C:\Program Files\OpenUEM Server\certificates\ca\ca.cer

You must import the certificate according to your browser’s settings

warning

If you're using a Linux machine you must create a copy of the certificate to a folder where you have permissions to read it as the certificates folder is owned by root

1.1 Chrome/Chromium/Brave​

  1. Go to Settings -> Privacy and Security. Scroll and click on the Security section. Scroll to Manage Certificates and click on it.
  2. Go to Local certificates and find the Custom section. Click on Installed by you.
  3. Next to Trusted certificates click on Import and select the location for the certificate.

1.2 Edge​

  1. Go to Settings -> Privacy, search, and services. Scroll to Security and click on Manage certificates.
  2. Go to Local certificates and click on Manage imported certificates from Windows.
  3. In the new window, click on the Trusted Root Certification Authorities tab and then click on Import and select the location for the certificate.
warning

In Windows, a warning will be shown when the Certificate Authority is imported. That warning is expected as you must confirm that you want to trust the certificates generated by this custom certificate authority.

1.3 Firefox​

  1. Go to Settings -> Privacy and Security. Find the Security section and in Certificates click on View Certificates.
  2. Import the CA certificate in the Authorities tab by selecting the location of the ca.cer file.
  3. Check "Trust this CA to identify websites" so that the CA can be used to validate web servers.

2. The administrator certificate:​

The file should be in the following locations:

  • Docker: certificates/users/admin.pfx in the docker compose folder
  • Linux: `/etc/openuem-server/certificates/users/admin.pfx``
  • Windows: C:\Program Files\OpenUEM Server\certificates\users\admin.pfx`
warning

The certificate is protected with the password changeit by default unless you've set a different password when you installed OpenUEM.

You must import the certificate according to your browser’s settings

warning

If you're using a Linux machine you must create a copy of the certificate to a folder where you have permissions to read it as the certificates folder is owned by root

2.1 Chrome/Chromium/Brave​

  1. Go to Settings -> Privacy and Security. Scroll and click on the Security section. Scroll to Manage Certificates and click on it.
  2. Go to Your certificates and click on Manage imported certificates from Windows.
  3. In the new window, click on the Personal tab tab and then click on Import and select the location for the admin.pfx certificate. Use the password to import it

2.2 Edge​

  1. Go to Settings -> Privacy, search, and services. Scroll to Security and click on Manage certificates.
  2. Go to Your certificates and click on Manage imported certificates from Windows.
  3. In the new window, click on the Personal tab tab and then click on Import and select the location for the admin.pfx certificate. Use the password to import it

2.3 Firefox​

  1. Go to Settings -> Privacy and Security. Find the Security section and in Certificates click on View Certificates.
  2. Import the certificate in the Your Certificate tab by selecting the location of the admin.pfx file. Use the password to import it

3. MacOS​

If you use Mac and find problems importing the admin.pfx certificate to your Chrome browser or Keychain, like invalid password, you may have to convert the PFX file opening a MacOS terminal and executing the following commands:

openssl pkcs12 -in admin.pfx -out admin.pem
openssl pkcs12 -export -in admin.pem -out new_admin.pfx -legacy

Then try to import the new admin pfx file